home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Freeware 2001 May
/
SGI Freeware 2001 May - Disc 1.iso
/
dist
/
fw_hylafax.idb
/
usr
/
freeware
/
man
/
cat4
/
destctrls.Z
/
destctrls
Wrap
Text File
|
2000-06-09
|
5KB
|
130 lines
DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555)))) DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF))))
NNNNAAAAMMMMEEEE
destctrls - per-destination controls for _H_y_l_a_F_A_X servers
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The _H_y_l_a_F_A_X configuration parameter DDDDeeeessssttttCCCCoooonnnnttttrrrroooollllssss specifies
whether or not to apply per-destination controls on job
characteristics such as the time-of-day to place a call.
The controls file is a simple ASCII file containing a series
of records of the form:
_d_e_s_t param = value ... param = value
where _d_e_s_t is a regular expression matched against the
canonical form of a destination phone number and parameters
are specified by named assignments (though the ``='' can
also be left out). Whitespace may be used freely though it
is used to identify the end of _d_e_s_t and the start of the
parameter list. Parameter values are parsed exactly as
specified in _c_o_n_f_i_g(4F); i.e. values with embedded
whitespace may be enclosed in quote marks (``"'').
Comments are introduced with a ``#'' character and extend to
the end of the line. Parameter lists may be continued
across lines by starting subsequent lines with a whitespace
character (lines commented out with ``#'' are also
considered to be part of a continued record).
The order of entries in a file is important. When a
parameter value is needed _f_a_x_q sequentially scans the file
until it finds a record that matches the canonical form of
the destination phone number. If the requested parameter is
defined in this record, then the value is returned,
otherwise a default value is used from the _f_a_x_q
configuration file.
The following parameters may be specified on a per-
destination basis; consult _c_o_n_f_i_g(4F) for a description of
each parameter (except RRRReeeejjjjeeeeccccttttNNNNoooottttiiiicccceeee which is described
below).
TTTTaaaagggg TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
MaxConcurrentJobs integer 1 max concurrent jobs to process for a destination
MaxDials integer _u_n_l_i_m_i_t_e_d max phone calls to make to transmit a job
MaxSendPages integer _u_n_l_i_m_i_t_e_d max pages to permit in a send
MaxTries integer 3 max attempts to transmit a job
RejectNotice string - rejection notice for transmit job
TimeOfDay string Any default time-of-day restrictions
The RRRReeeejjjjeeeeccccttttNNNNoooottttiiiicccceeee parameter controls whether or not to reject
jobs to the destination. Jobs that are rejected are done so
without placing a phone call and the associated message is
returned to the job submitter. This facility can be used to
disallow calling sensitive phone numbers; for example
Page 1 (printed 3/21/00)
DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555)))) DDDDEEEESSSSTTTTCCCCTTTTRRRRLLLLSSSS((((4444FFFF))))
.*911$ RejectNotice = "Calls to emergency numbers are not permitted"
In addition to the above parameters, any other parameters
that are specified are automatically accumulated and passed
to programs invoked by _f_a_x_q, such as _f_a_x_s_e_n_d and _p_a_g_e_s_e_n_d.
This is a convenient mechanism for defining configuration
parameters for all modems without having to modify each
modem-specific configuration file. For example,
.* SessionTracing = 0x4f
This mechanism also makes it easy to control transmit-
related parameters according to the destination phone
number. For example, to disable use of ECM and restrict the
transmit speed when placing international phone calls one
might use:
[+][^1] DesiredBR=9600 DesiredEC=false
NNNNOOOOTTTTEEEESSSS
Beware that canonical phone numbers have a leading ``+''
which is a special character for regular expressions. An
easy way to match ``+'' is with ``[+]''; e.g.
``[+]14159657824''.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
_f_a_x_q(1M), _c_o_n_f_i_g(4F), _r_e__f_o_r_m_a_t(7).
Page 2 (printed 3/21/00)